Skip to main content
PATCH
`PATCH /v1/me/webhooks/{id}` — partial update of a subscription keeping its `id` (and so its `webhook_deliveries` history) intact.

Authorizations

Authorization
string
header
required

Session JWT issued by POST /v1/auth/telegram (Telegram Login Widget) or POST /v1/auth/magic/consume. Send as Authorization: Bearer <jwt>.

Path Parameters

id
string<uuid>
required

Webhook subscription id

Body

application/json
channel_type
string | null

Override the channel flavor ("generic"|"discord"|"slack") when auto-detection guessed wrong. Omit to leave unchanged.

is_active
boolean | null

Toggle active state without deleting the row. Useful for pause-then-resume during receiver maintenance.

threshold_bps
integer<int32> | null

Replace the alert threshold (1..10000 bps). Omit to leave unchanged.

url
string | null

Replace the destination URL. SSRF + length guards re-applied; omit to leave unchanged.

Response

Updated webhook

asset
string
required
channel_type
string
required

"generic" | "discord" | "slack". Auto-detected from the URL on create when omitted; overridable via PATCH. Decides how alerts render (Discord embed / Slack attachment / generic signed JSON).

id
string<uuid>
required
is_active
boolean
required
threshold_bps
integer<int32>
required
url
string
required